<html>
<head><meta charset="utf-8"><title>forge vs compiler-team vs rustc-dev-guide · t-compiler · Zulip Chat Archive</title></head>
<h2>Stream: <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/index.html">t-compiler</a></h2>
<h3>Topic: <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/forge.20vs.20compiler-team.20vs.20rustc-dev-guide.html">forge vs compiler-team vs rustc-dev-guide</a></h3>

<hr>

<base href="https://rust-lang.zulipchat.com">

<head><link href="https://rust-lang.github.io/zulip_archive/style.css" rel="stylesheet"></head>

<a name="195624343"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/forge%20vs%20compiler-team%20vs%20rustc-dev-guide/near/195624343" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Santiago Pastorino <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/forge.20vs.20compiler-team.20vs.20rustc-dev-guide.html#195624343">(Apr 28 2020 at 20:45)</a>:</h4>
<p>during a <span class="user-group-mention" data-user-group-id="1380">@WG-rustc-dev-guide</span> meeting we were discussing the difference between what should go in forge, compiler-team and rustc-dev-guide</p>



<a name="195624399"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/forge%20vs%20compiler-team%20vs%20rustc-dev-guide/near/195624399" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Santiago Pastorino <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/forge.20vs.20compiler-team.20vs.20rustc-dev-guide.html#195624399">(Apr 28 2020 at 20:45)</a>:</h4>
<p>in some sense it seems like rustc-dev-guide should be about understanding how the compiler works</p>



<a name="195624422"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/forge%20vs%20compiler-team%20vs%20rustc-dev-guide/near/195624422" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Santiago Pastorino <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/forge.20vs.20compiler-team.20vs.20rustc-dev-guide.html#195624422">(Apr 28 2020 at 20:45)</a>:</h4>
<p>in forge we have some procedures</p>



<a name="195624543"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/forge%20vs%20compiler-team%20vs%20rustc-dev-guide/near/195624543" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Santiago Pastorino <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/forge.20vs.20compiler-team.20vs.20rustc-dev-guide.html#195624543">(Apr 28 2020 at 20:46)</a>:</h4>
<p>but it's not 100% clear what should go on each place</p>



<a name="195624572"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/forge%20vs%20compiler-team%20vs%20rustc-dev-guide/near/195624572" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Santiago Pastorino <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/forge.20vs.20compiler-team.20vs.20rustc-dev-guide.html#195624572">(Apr 28 2020 at 20:46)</a>:</h4>
<p>for instance:</p>



<a name="195624596"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/forge%20vs%20compiler-team%20vs%20rustc-dev-guide/near/195624596" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Santiago Pastorino <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/forge.20vs.20compiler-team.20vs.20rustc-dev-guide.html#195624596">(Apr 28 2020 at 20:47)</a>:</h4>
<p>we have a procedures section in compiler-team <a href="https://rust-lang.github.io/compiler-team/procedures/crates/" title="https://rust-lang.github.io/compiler-team/procedures/crates/">https://rust-lang.github.io/compiler-team/procedures/crates/</a></p>



<a name="195624605"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/forge%20vs%20compiler-team%20vs%20rustc-dev-guide/near/195624605" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Santiago Pastorino <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/forge.20vs.20compiler-team.20vs.20rustc-dev-guide.html#195624605">(Apr 28 2020 at 20:47)</a>:</h4>
<p>but some other procedures were moved to forge</p>



<a name="195624738"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/forge%20vs%20compiler-team%20vs%20rustc-dev-guide/near/195624738" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Santiago Pastorino <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/forge.20vs.20compiler-team.20vs.20rustc-dev-guide.html#195624738">(Apr 28 2020 at 20:48)</a>:</h4>
<p>and we have things like <a href="https://rustc-dev-guide.rust-lang.org/ice-breaker/about.html" title="https://rustc-dev-guide.rust-lang.org/ice-breaker/about.html">https://rustc-dev-guide.rust-lang.org/ice-breaker/about.html</a> what's an ice-breaker group and how works, that seems a bit like a procedure to me and also things like <a href="https://rustc-dev-guide.rust-lang.org/stabilization_guide.html" title="https://rustc-dev-guide.rust-lang.org/stabilization_guide.html">https://rustc-dev-guide.rust-lang.org/stabilization_guide.html</a></p>



<a name="195625032"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/forge%20vs%20compiler-team%20vs%20rustc-dev-guide/near/195625032" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Santiago Pastorino <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/forge.20vs.20compiler-team.20vs.20rustc-dev-guide.html#195625032">(Apr 28 2020 at 20:50)</a>:</h4>
<p>there are a lot of things that are debatable and we may try to figure out but I guess a high level idea of what should go on each would be great :)</p>



<a name="195625041"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/forge%20vs%20compiler-team%20vs%20rustc-dev-guide/near/195625041" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Santiago Pastorino <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/forge.20vs.20compiler-team.20vs.20rustc-dev-guide.html#195625041">(Apr 28 2020 at 20:50)</a>:</h4>
<p>cc <span class="user-mention" data-user-id="116009">@nikomatsakis</span> <span class="user-mention" data-user-id="116083">@pnkfelix</span></p>



<a name="195628501"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/forge%20vs%20compiler-team%20vs%20rustc-dev-guide/near/195628501" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> nagisa <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/forge.20vs.20compiler-team.20vs.20rustc-dev-guide.html#195628501">(Apr 28 2020 at 21:19)</a>:</h4>
<p>to me forge was always about having a higher-level view around our processes. Examples:</p>
<ol>
<li>When is the next release?</li>
<li>What targets do we support?</li>
</ol>
<p>and similar. I could see compiler-team page being a subsection in forge instead.</p>



<a name="195629123"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/forge%20vs%20compiler-team%20vs%20rustc-dev-guide/near/195629123" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Santiago Pastorino <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/forge.20vs.20compiler-team.20vs.20rustc-dev-guide.html#195629123">(Apr 28 2020 at 21:24)</a>:</h4>
<p><span class="user-mention" data-user-id="123586">@nagisa</span> in that sense, where do you think <a href="https://rustc-dev-guide.rust-lang.org/ice-breaker/about.html" title="https://rustc-dev-guide.rust-lang.org/ice-breaker/about.html">https://rustc-dev-guide.rust-lang.org/ice-breaker/about.html</a>, <a href="https://rustc-dev-guide.rust-lang.org/stabilization_guide.html" title="https://rustc-dev-guide.rust-lang.org/stabilization_guide.html">https://rustc-dev-guide.rust-lang.org/stabilization_guide.html</a> and <a href="https://rust-lang.github.io/compiler-team/procedures/crates/" title="https://rust-lang.github.io/compiler-team/procedures/crates/">https://rust-lang.github.io/compiler-team/procedures/crates/</a> should go? :)</p>



<a name="195633810"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/forge%20vs%20compiler-team%20vs%20rustc-dev-guide/near/195633810" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> nikomatsakis <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/forge.20vs.20compiler-team.20vs.20rustc-dev-guide.html#195633810">(Apr 28 2020 at 22:05)</a>:</h4>
<p>So, I put the ice-breaker stuff in rustc-dev-guide because it was connected to "contribution"</p>



<a name="195633818"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/forge%20vs%20compiler-team%20vs%20rustc-dev-guide/near/195633818" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> nikomatsakis <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/forge.20vs.20compiler-team.20vs.20rustc-dev-guide.html#195633818">(Apr 28 2020 at 22:05)</a>:</h4>
<p>i.e., it's a way to get involved</p>



<a name="195633827"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/forge%20vs%20compiler-team%20vs%20rustc-dev-guide/near/195633827" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> nikomatsakis <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/forge.20vs.20compiler-team.20vs.20rustc-dev-guide.html#195633827">(Apr 28 2020 at 22:06)</a>:</h4>
<p>and not so much a "procedure"</p>



<a name="195633905"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/forge%20vs%20compiler-team%20vs%20rustc-dev-guide/near/195633905" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> nikomatsakis <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/forge.20vs.20compiler-team.20vs.20rustc-dev-guide.html#195633905">(Apr 28 2020 at 22:06)</a>:</h4>
<p>though I agree it could potentially live in both places, and one could imagine forge having a "forwarding link" to rustc-dev-guide</p>



<a name="195633979"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/forge%20vs%20compiler-team%20vs%20rustc-dev-guide/near/195633979" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> nikomatsakis <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/forge.20vs.20compiler-team.20vs.20rustc-dev-guide.html#195633979">(Apr 28 2020 at 22:06)</a>:</h4>
<p>Stabilizing features is particularly complicated because it overlaps to some extent with other teams, like lang team etc</p>



<a name="195634003"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/forge%20vs%20compiler-team%20vs%20rustc-dev-guide/near/195634003" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> nikomatsakis <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/forge.20vs.20compiler-team.20vs.20rustc-dev-guide.html#195634003">(Apr 28 2020 at 22:07)</a>:</h4>
<p>but I guess that by the logic of "kinds of contributions" it fits</p>



<a name="195634027"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/forge%20vs%20compiler-team%20vs%20rustc-dev-guide/near/195634027" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> nikomatsakis <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/forge.20vs.20compiler-team.20vs.20rustc-dev-guide.html#195634027">(Apr 28 2020 at 22:07)</a>:</h4>
<p>I hvae to say that Part 1 of the rustc-dev-guide kind of looks like a hodge podge right now as I skim ot iver</p>



<a name="195634094"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/forge%20vs%20compiler-team%20vs%20rustc-dev-guide/near/195634094" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> nikomatsakis <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/forge.20vs.20compiler-team.20vs.20rustc-dev-guide.html#195634094">(Apr 28 2020 at 22:07)</a>:</h4>
<blockquote>
<p><a href="https://rust-lang.github.io/compiler-team/procedures/crates/" title="https://rust-lang.github.io/compiler-team/procedures/crates/">https://rust-lang.github.io/compiler-team/procedures/crates/</a></p>
</blockquote>
<p>I think this clearly belongs in forge, I think that the compiler-team website should be deprecated in favor of forge for this sort of thing</p>



<a name="195634178"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/forge%20vs%20compiler-team%20vs%20rustc-dev-guide/near/195634178" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> nikomatsakis <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/forge.20vs.20compiler-team.20vs.20rustc-dev-guide.html#195634178">(Apr 28 2020 at 22:08)</a>:</h4>
<p>I think the role of the compiler-team website is probably just limited to tracking minutes, proposals, and working groups and things</p>



<a name="195634237"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/forge%20vs%20compiler-team%20vs%20rustc-dev-guide/near/195634237" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> nikomatsakis <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/forge.20vs.20compiler-team.20vs.20rustc-dev-guide.html#195634237">(Apr 28 2020 at 22:08)</a>:</h4>
<p>I'm not 100% convinced though that the "ICE-breaker content" belongs in rustc-dev-guide, and could be persuaded that it should move to forge, along with other "contributor like" material</p>



<a name="195634280"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/forge%20vs%20compiler-team%20vs%20rustc-dev-guide/near/195634280" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> nikomatsakis <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/forge.20vs.20compiler-team.20vs.20rustc-dev-guide.html#195634280">(Apr 28 2020 at 22:09)</a>:</h4>
<p>in that case, rustc-dev-guide would be really focused more on <em>documenting rustc</em> and not so much the procedure around contribution, issue triage, etc</p>



<a name="195634300"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/forge%20vs%20compiler-team%20vs%20rustc-dev-guide/near/195634300" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> nikomatsakis <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/forge.20vs.20compiler-team.20vs.20rustc-dev-guide.html#195634300">(Apr 28 2020 at 22:09)</a>:</h4>
<p>I think I would probably also move out then the stabilization PRs, as well as like "walking you through your first contribution"</p>



<a name="195634310"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/forge%20vs%20compiler-team%20vs%20rustc-dev-guide/near/195634310" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> nikomatsakis <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/forge.20vs.20compiler-team.20vs.20rustc-dev-guide.html#195634310">(Apr 28 2020 at 22:09)</a>:</h4>
<p>and have a link over to forge for that sort of thing</p>



<a name="195693261"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/forge%20vs%20compiler-team%20vs%20rustc-dev-guide/near/195693261" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Santiago Pastorino <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/forge.20vs.20compiler-team.20vs.20rustc-dev-guide.html#195693261">(Apr 29 2020 at 11:17)</a>:</h4>
<p><span class="user-mention" data-user-id="116009">@nikomatsakis</span> this is exactly what I was thinking :)</p>



<a name="195693276"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/forge%20vs%20compiler-team%20vs%20rustc-dev-guide/near/195693276" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Santiago Pastorino <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/forge.20vs.20compiler-team.20vs.20rustc-dev-guide.html#195693276">(Apr 29 2020 at 11:17)</a>:</h4>
<p>make rustc-dev-guide more focused on documenting rustc</p>



<a name="195693353"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/forge%20vs%20compiler-team%20vs%20rustc-dev-guide/near/195693353" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Santiago Pastorino <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/forge.20vs.20compiler-team.20vs.20rustc-dev-guide.html#195693353">(Apr 29 2020 at 11:18)</a>:</h4>
<p>it should totally have a contributing section but that section could be short, with links to ice breakers page and things like that that live in forge</p>



<a name="195693394"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/forge%20vs%20compiler-team%20vs%20rustc-dev-guide/near/195693394" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Santiago Pastorino <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/forge.20vs.20compiler-team.20vs.20rustc-dev-guide.html#195693394">(Apr 29 2020 at 11:19)</a>:</h4>
<p>so we can make rustc-dev-guide more readable and more focused on understanding how the compiler works</p>



<a name="195793041"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/forge%20vs%20compiler-team%20vs%20rustc-dev-guide/near/195793041" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> mark-i-m <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/forge.20vs.20compiler-team.20vs.20rustc-dev-guide.html#195793041">(Apr 30 2020 at 02:34)</a>:</h4>
<p><span class="user-mention silent" data-user-id="116009">nikomatsakis</span> <a href="#narrow/stream/131828-t-compiler/topic/forge.20vs.20compiler-team.20vs.20rustc-dev-guide/near/195634027" title="#narrow/stream/131828-t-compiler/topic/forge.20vs.20compiler-team.20vs.20rustc-dev-guide/near/195634027">said</a>:</p>
<blockquote>
<p>I hvae to say that Part 1 of the rustc-dev-guide kind of looks like a hodge podge right now as I skim ot iver</p>
</blockquote>
<p>Yes, this sprint the wg wants to fix this...</p>



<a name="195793075"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/forge%20vs%20compiler-team%20vs%20rustc-dev-guide/near/195793075" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> mark-i-m <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/forge.20vs.20compiler-team.20vs.20rustc-dev-guide.html#195793075">(Apr 30 2020 at 02:35)</a>:</h4>
<p>Personally, I lean towards having the guide be a 1-stop shop for all the things a contributor could need, but others in the WG would like it to be more book-like.</p>



<a name="195845864"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/forge%20vs%20compiler-team%20vs%20rustc-dev-guide/near/195845864" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> nikomatsakis <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/forge.20vs.20compiler-team.20vs.20rustc-dev-guide.html#195845864">(Apr 30 2020 at 14:22)</a>:</h4>
<p>I think that having Part 1 have some pointers to forge, appendix, or other content can be a middle ground</p>



<a name="195845875"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/forge%20vs%20compiler-team%20vs%20rustc-dev-guide/near/195845875" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> nikomatsakis <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/forge.20vs.20compiler-team.20vs.20rustc-dev-guide.html#195845875">(Apr 30 2020 at 14:22)</a>:</h4>
<p>it's what I would prefer, I think</p>



<a name="195845944"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/forge%20vs%20compiler-team%20vs%20rustc-dev-guide/near/195845944" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> nikomatsakis <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/forge.20vs.20compiler-team.20vs.20rustc-dev-guide.html#195845944">(Apr 30 2020 at 14:22)</a>:</h4>
<p>I was saying to <span class="user-mention" data-user-id="116266">@Santiago Pastorino</span> that it seems like a good "rule of thumb" might be -- the rustc-guide is all about what you can do after you clone the git repo. It's not about things that require interacting with github issues =)</p>



<a name="195901145"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/forge%20vs%20compiler-team%20vs%20rustc-dev-guide/near/195901145" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> mark-i-m <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/forge.20vs.20compiler-team.20vs.20rustc-dev-guide.html#195901145">(Apr 30 2020 at 21:03)</a>:</h4>
<p>I guess my question is why? What goal does it accomplish? Making the rustc-dev-guide readable as book is cool, but does it serve any real need? Personally, when I was starting out in contributing, I was a bit bewildered by the fact that information is spread out in soooo many places. We use 4-5 different platforms for discussion, the forge, compiler-team, rustc-dev-guide, tracking issues, random hackmds and dropbox papers... It just seems like it would be helpful to consolidate information somewhere.</p>



<a name="196045269"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/forge%20vs%20compiler-team%20vs%20rustc-dev-guide/near/196045269" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> nikomatsakis <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/forge.20vs.20compiler-team.20vs.20rustc-dev-guide.html#196045269">(May 02 2020 at 10:28)</a>:</h4>
<p>I think my concern is that the more stuff we add into rustc-dev-guide, the more it itself is bewildering.</p>



<a name="196045273"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/forge%20vs%20compiler-team%20vs%20rustc-dev-guide/near/196045273" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> nikomatsakis <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/forge.20vs.20compiler-team.20vs.20rustc-dev-guide.html#196045273">(May 02 2020 at 10:28)</a>:</h4>
<p>But I feel like having it be a link to forge</p>



<a name="196045275"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/forge%20vs%20compiler-team%20vs%20rustc-dev-guide/near/196045275" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> nikomatsakis <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/forge.20vs.20compiler-team.20vs.20rustc-dev-guide.html#196045275">(May 02 2020 at 10:28)</a>:</h4>
<p>Serves two purposes</p>



<a name="196045281"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/forge%20vs%20compiler-team%20vs%20rustc-dev-guide/near/196045281" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> nikomatsakis <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/forge.20vs.20compiler-team.20vs.20rustc-dev-guide.html#196045281">(May 02 2020 at 10:28)</a>:</h4>
<p>First off, it lets you know forge exists :)</p>



<a name="196045285"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/forge%20vs%20compiler-team%20vs%20rustc-dev-guide/near/196045285" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> nikomatsakis <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/forge.20vs.20compiler-team.20vs.20rustc-dev-guide.html#196045285">(May 02 2020 at 10:29)</a>:</h4>
<p>And it helps us to keep the rustc-dev-guide ToC readable and focused</p>



<a name="196045296"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/forge%20vs%20compiler-team%20vs%20rustc-dev-guide/near/196045296" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> nikomatsakis <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/forge.20vs.20compiler-team.20vs.20rustc-dev-guide.html#196045296">(May 02 2020 at 10:29)</a>:</h4>
<p>I do think it's important that it has appendices and sections</p>



<a name="196045300"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/forge%20vs%20compiler-team%20vs%20rustc-dev-guide/near/196045300" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> nikomatsakis <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/forge.20vs.20compiler-team.20vs.20rustc-dev-guide.html#196045300">(May 02 2020 at 10:29)</a>:</h4>
<p>I guess the alternative is to move all compiler team material into rustc-dev-guide --</p>



<a name="196045303"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/forge%20vs%20compiler-team%20vs%20rustc-dev-guide/near/196045303" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> nikomatsakis <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/forge.20vs.20compiler-team.20vs.20rustc-dev-guide.html#196045303">(May 02 2020 at 10:29)</a>:</h4>
<p>but I think that team procedures and things will overlap with other teams</p>



<a name="196045308"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/forge%20vs%20compiler-team%20vs%20rustc-dev-guide/near/196045308" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> nikomatsakis <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/forge.20vs.20compiler-team.20vs.20rustc-dev-guide.html#196045308">(May 02 2020 at 10:29)</a>:</h4>
<p>e.g., I'd like to have centralized docs for "so you want to make a change ..." that guides folks on whether they need to write an RFC etc</p>



<a name="196045311"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/forge%20vs%20compiler-team%20vs%20rustc-dev-guide/near/196045311" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> nikomatsakis <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/forge.20vs.20compiler-team.20vs.20rustc-dev-guide.html#196045311">(May 02 2020 at 10:30)</a>:</h4>
<p>and I think we can centralize all the team docs for that on forge</p>



<a name="196045351"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/forge%20vs%20compiler-team%20vs%20rustc-dev-guide/near/196045351" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> nikomatsakis <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/forge.20vs.20compiler-team.20vs.20rustc-dev-guide.html#196045351">(May 02 2020 at 10:30)</a>:</h4>
<p>I don't think it would make sense to put all that into rustc-dev-guide</p>



<a name="196200951"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/forge%20vs%20compiler-team%20vs%20rustc-dev-guide/near/196200951" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Santiago Pastorino <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/forge.20vs.20compiler-team.20vs.20rustc-dev-guide.html#196200951">(May 04 2020 at 15:56)</a>:</h4>
<p>agree with <span class="user-mention" data-user-id="116009">@nikomatsakis</span> here, I think consolidating is good, forge for all the processes of all the teams, rustc-dev-guide for all that is how the compiler works</p>



<a name="196201006"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/forge%20vs%20compiler-team%20vs%20rustc-dev-guide/near/196201006" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Santiago Pastorino <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/forge.20vs.20compiler-team.20vs.20rustc-dev-guide.html#196201006">(May 04 2020 at 15:56)</a>:</h4>
<p>anyway, I agree that we can link from rustc-dev-guide to forge in a lot of places</p>



<a name="196207142"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/forge%20vs%20compiler-team%20vs%20rustc-dev-guide/near/196207142" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> mark-i-m <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/forge.20vs.20compiler-team.20vs.20rustc-dev-guide.html#196207142">(May 04 2020 at 16:38)</a>:</h4>
<p>I guess I would still rather have everything in one place, but I seem to be in the minority. I'm willing to give it try and maybe evaluate again afterwards</p>



<a name="196209885"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/131828-t-compiler/topic/forge%20vs%20compiler-team%20vs%20rustc-dev-guide/near/196209885" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Santiago Pastorino <a href="https://rust-lang.github.io/zulip_archive/stream/131828-t-compiler/topic/forge.20vs.20compiler-team.20vs.20rustc-dev-guide.html#196209885">(May 04 2020 at 17:00)</a>:</h4>
<p><span class="user-mention" data-user-id="198054">@mark-i-m</span> yeah, we can try things and revert if they don't look great</p>



<hr><p>Last updated: Aug 07 2021 at 22:04 UTC</p>
</html>